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Technical Note: 


SMAC Tool 


The purpose of the SMAC (System Monitor and Control) tool is to allow 
you to monitor the status of AOL host servers in various test systems, 
establish and maintain connections to the servers, and execute commands 
on the servers. 


SMAC has a UNIX command line interface and an extensive set of 
commands to allow you to monitor and control host servers. These 
commands allow you to receive detailed status information on the servers, 
execute commands on multiple servers simultaneously, execute samon 
commands, and receive asynchronous data from any server. You can also 
start a telnet session through your xterm window to control a server 
directly. 


Some SMAC commands can be executed by anyone, but most commands 
require you to have a SMAC user account. Contact your tool administrator 
to give you access to SMAC. After you have access to SMAC, you can 
request a user account from a SMAC administrator as described on page 7. 


Who Should Use This Technical Note 


This document is intended only for internal America Online employees of 
Systems Development and Operations who need to access AOL host 
servers. This could be someone maintaining his or her own server or 
someone who maintains an entire host system. 


Providing Feedback 


If you have comments, corrections, or questions related to this technical 
note, please send e-mail to screen name DevelopHlIp. Please include the 
name of this technical note when providing your feedback. 
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Users and Privileges 


A user, in the context of the SMAC tool, is someone who can run SMAC 
commands. All users have a corresponding privilege level that determines 
the SMAC commands they can execute. Your SMAC administrator will 
determine your privilege level depending on your needs. There are three 
privilege levels, shown below in order of the lowest privilege to the highest: 


Privilege Level Description 


Any Everyone with access to the SMAC tool has a 
privilege level of "Any" by default. You do not need 
to have a user account. 


Users with a privilege level of "Any" can only specify 
which test system they want to work with and display 
the status of the servers in that test system. See 

page 13 for a list of commands that can be executed at 
the "Any" level. 


User Users with a privilege level of "User" can execute 
every SMAC command except the administration 
commands. Most users have a privilege level of 
"User". See page 13 for a list of commands that can be 
executed at the "User" level. 


Admin Users with a privilege level of "Admin" can execute 
every SMAC command, including the administration 
commands. These users are SMAC administrators. 
See page 14 for a list of commands that can be 
executed at the "Admin" level. 


Each SMAC command has a privilege level associated with it. To execute a 
particular command, you must have a privilege level at or higher than the 
command’s required privilege level. 


To determine your privilege level, execute the whoami command 
(described on page 41). Your user name and privilege level will be 


displayed. 


For information about getting an account and accessing SMAC, see 
“Getting Started with SMAC” on page 7. 
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Getting Started with SMAC 


This section describes the tasks associated with accessing and logging in to 
the SMAC tool. You must first contact your tool administrator to find out a 
host name and control port where SMAC can be accessed. 


The tasks you perform next depend on which commands you want to 
execute. If you want to be able to execute commands at the "User" or 
"Admin" level, you must first obtain a user account from a SMAC 
administrator as described in “Getting a User Account” on page 7. 


If you already have a user account, or if you only want to be able to execute 
commands at the "Any" level, skip to “Accessing SMAC” on page 8. 


Getting a User Account 


To execute SMAC commands with a privilege level of "User" or "Admin", 
you must first obtain a SMAC user account. 


To get a user account on SMAC, perform the following steps: 


1. 


Access the SMAC tool by using telnet to connect to the appropriate 
control port on your SMAC host. For example, if your host is 
abcqa.test, and the control port is 1234, you would type: 


telnet abcqa.test 1234 


The following prompt appears: 


Please login> 


Execute the new_user command with your first name, last name, e- 
mail address, and your preferred user name to request a user account. 
For example: 


new_user Joseph Darby JoeD@aol.com joe 


An e-mail message will be sent toa SMAC administrator with your 
request. The administrator will create a user account for you and notify 
you of your user name, password, and privilege level. Most users are 
assigned the "User" privilege level. 


Log out of SMAC by typing: 


exit 
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4. When you receive your SMAC account information from the 
administrator, access SMAC again as described above in Step 2. 


5. Change your password with the login command. For example, if you 
were assigned a user name of joe and a password of xyz123, you can 
change your password to jk189 by typing: 


login joe xyz123 jk189 4k189 


6. Because you are now logged in to SMAC, continue with “Setting the 
Test System” on page 9. 


Accessing SMAC 


To access SMAC, perform the following steps: 


1. Access the SMAC tool by using telnet to connect to the appropriate 
control port on your SMAC host. For example, if your host is 
abcqa.test, and the control port is 1234, you would type: 


telnet abcqa.test 1234 


You can now execute any SMAC command with a privilege level of 
"Any". If you have a SMAC user account, you can execute SMAC 
commands with a privilege level of "User" or "Admin" after you log in as 
described in the next section. 


Logging In 


You must log in to execute SMAC commands with a privilege level of 
"User" or "Admin". When you access the SMAC tool, the following 
prompt appears: 


Please login> 
Use the login command to log in to the system, specifying your user name 
and password. For example, if your user name is joe and your password is 
jk189, you would type: 


login joe jk189 


See page 30 for detailed information about the login command. 
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Setting the Test System 


Before you can execute SMAC commands for any servers, you must 
specify which test system you want to work with. If you have logged in, the 
following prompt appears: 


Please set system> 


If you have not logged in, the prompt will be "Please login>", but you can 
still perform the following procedure. 


To set the test system, perform the following steps: 
1. Display a list of the available test systems by typing: 
set_system 


2. Specify the test system you want to work in with the set_system 
command. For example: 


set_system qa 


Once you set the test system, the prompt displays the name of the test 
system you are working with. For example: 


qa> 


See page 37 for detailed information about the set_system command. 


Getting Help 


There is a standard UNIX help library mechanism for the SMAC tool. To 
get help on SMAC commands, type: 


help smac 
A list of general SMAC commands and their syntax appears, along with the 
names of other categories of SMAC commands. To see a list of commands 
and syntax for any of the categories, type: 

help <category name> 


To get more detailed information about any command, type: 


help <command name> 
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A complete reference of all the SMAC commands begins on page 13. 


Server Monitoring and Control 


This section describes some of the most common tasks that can be 
performed on servers with the SMAC tool. A complete reference of all the 
SMAC commands begins on page 13. 


Displaying and Interpreting Server Status 


First, make sure that you are working with the test system where the server 
or servers reside. The command line prompt shows the test system you are 
currently working with. To get a list of the available test systems, execute 
the set_system command (described on page 37) with no parameters. To 
work with a different test system, execute set_system again, specifying the 
test system on the command line. 


To display the status of one or more servers, use the list_server command. 
Executing list_server with no parameters displays the status of every 
server in the test system. Alternatively, you can select a specific server, all 
servers that are up, or all servers that are down. See page 27 for detailed 
information about the list_server command. 


You can list the status of servers sorted by groups with the list_groups 
command (described on page 26). 


The status information for the server or servers appears in the Status 
column (for the control port) and the Samon column (for the samon port) of 
the status output. These are the possible status values and their descriptions: 


Up There is a connection to the server. You can execute 
commands on the server only if its status is up. 


Lost There was a connection to the server, but the connection 
went down at some point. This was probably caused by a 
bounce. You can use the init_conn command to re- 
establish the connection. See page 23 for detailed 
information about the init_conn command. 


Stopped There was a connection to the server, but it was manually 
stopped using the stop_conn command (described on 
page 39). You can use the init_conn command to re- 
establish the connection. 
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Uninit A connection to the server was never attempted. You can 
use the init_conn command to initialize a connection. 


Another status indicator is found in the K/O column of the status output. 
Usually this column is empty, but if "yes" appears in this column, it means 
that a connection to that server is being kept open with the keep_open 
command. All data from that server will be sent to the user who executed 
the keep_open command. See page 24 for detailed information about the 
keep_open command. 


Submitting Commands on a Server 


There are two ways to execute a command on a server: with the cmd 
command (described on page 20), or by using the spawn command to start 
a telnet session through your xterm window as described on page 12. 


If you routinely want to execute the same command on multiple servers, 
you may want to consider forming server groups. Create a new group with 
the add_group command (described on page 15). Associate servers with 
the new group with the add_to_group command (described on page 17). 


The cmd command allows you to specify a group name on which to 
execute your command. Your command will be submitted simultaneously 
to every server in the group. 


Executing Samon Commands 


Samon is an application that controls a group of AOL host servers. All of 
the host servers that are controlled by a samon have the same samon port, 
which identifies the samon that is controlling them. You can then send 
samon commands to the samon through this port. 


To send a samon command to a server’s samon, use the -s option with the 
cmd command. For example, you can bounce a server using SMAC if the 
server has a samon. To bounce the yawp server, execute this command: 


cmd yawp —-s stop_job yawp 


To get information on samon commands from inside the SMAC tool, you 
can execute a help samon command on any server that has a samon port. 
For example: 


cmd yawp -s help samon 
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See page 20 for detailed information about the cmd command. 


Asynchronous Server Output 


AOL host servers can produce asynchronous (unsolicited) data. This 
primarily occurs when logging has been activated in the control port of the 
server. This is sometimes called "kitchen sink logging". 


With SMAC you can keep open the connection to that server to receive this 
data using the keep_open command. Any data received from that server is 
then displayed to you. 


For example, to have all data received from the yawp server sent to you, 
you would execute this command: 


keep_open yawp 


Once you do this, the status for the server shows "yes" in the K/O column 
when you execute the list_server command. See page 27 for detailed 
information about the list_server command. 


To close a kept-open connection, execute the keep_open command with 
the -c option. For example: 


keep_open -c yawp 


See page 24 for detailed information about the keep_open command. 


Executing Commands in a New xterm 


If you don’t want to keep typing the name of your server each time you 
send a command, as you must do with the cmd command, you can use the 
spawn command to start a telnet session to your server through your xterm 
window. 


You must first allow your computer to display from the computer running 
SMAC. You can do this with the xhost + command on your computer. 


Then you can submit a spawn command in SMAC, specifying the server 


name you’re working with and the host name of your computer. For 
example: 


spawn yawp pluto.test 
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See page 38 for detailed information about the spawn command. 


SMAC Commands 


This section describes each of the SMAC commands in detail. The 


following tables provide a summary of each command by privilege level: 








Table 1: Commands for All Users ("Any" Level) 

Command Description Page 

help Get help about SMAC commands page 22 

list_server List each server along with its current page 27 
status 

login Log in to the SMAC tool page 30 

new_user Submit a request fora SMAC user page 32 
account 

set_system Specify the test system to work with page 37 

Table 2: Commands for SMAC Users ("User" Level) 

Command Description Page 

add_group Create a new group page 15 

add_server Add a server to a test system page 16 

add_to_group Add a server to a group page 17 

cmd Execute a command on a server or page 20 
group of servers 

init_conn Connect to a server’s control port page 23 

keep_open Keep an open connection to aserver page 24 
to receive data 

list_groups List the groups in a test system page 26 

list_users List users currently logged in page 29 

mod_server Modify server specifications page 31 

remove_from_group Remove a server from a group page 34 

remove_group Remove a group page 35 

remove_server Remove a server page 36 

spawn Spawn a telnet session to a server page 38 

stop_conn Stop a connection to a server page 39 

tell Send an Instant Message to another page 40 
user 

whoami Display the current user’s username __ page 41 
and privilege level 
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Table 3: Commands for SMAC Administrators ("Admin" Level) 





Command Description Page 

add_user Add a SMAC user page 18 
kill_ tool Kill the SMAC process page 25 
list_users -a List all known users page 29 


Aliases 


Many of the SMAC commands have an alias, which is a shortened version 
of the command that can be used in place of the full command name. For 
example, the alias for the list_server command is Is. Therefore, the 
following two examples are equivalent: 


list_server -a mail 


Or: 


ls -a mail 


America Online Confidential 14 © America Online, Inc. 1999 


February 1999 Technical Note: SMAC Tool 


add_ group 


Create a new group 


Privilege Level 


User 
Syntax 
add_group <Group Name> 
where: 
<Group Name> is the name of the new group. 
Alias 
ag 
Description 
add_group creates a new group with the specified name. After creating a 
group, add servers to the group with the add_to_group command. You can 
then use the cmd command to send a command to every server in the group 
simultaneously. 
Example 


This example creates a group named talisman: 


add_group talisman 
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add_server 


Add a server to a test system 


Privilege Level 


User 
Syntax 
add_server <Test System> <Server> <Host> <Port> [Samon Port] 
where: 
<Test System> is the name of the test system to which the server is to 
belong. 
<Server> is the name of the server. 
<Host> is the host the server is running on. 
<Port> is the server’s port number. 
[Samon Port] 1s the server’s samon port. Include this argument only if 
the server’s samon port is different than the default samon port. Your 
SMAC administrator can tell you what the default samon port is for the 
test system you are working with. 
Alias 
as 
Description 
add_server adds a server to the specified test system. Once a server has 
been added to a test system, you can monitor and control it using SMAC 
commands. 
Example 


This example adds the yawp server to the qa test system. The server’s host 
is tpod50.test and its port is 39265. Its samon port number is 39001. 


add_server qa yawp tpod50.test 39265 39001 
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add_to group 


Add a server to a group 


Privilege Level 


User 


Syntax 





add_to_group <Group Name> <Test System> <Server Name> 
where: 
<Group Name> is the name of the group to which the server is to belong. 


<Test System> is the name of the test system to which the server 
belongs. 


<Server Name> is the name of the server to be added to the group. 


Alias 
atg 
Description 
add_to_group adds a server to a group. After adding a server to a group, 


you can then use the emd command to send a command simultaneously to 
every server in the group. 


Example 


This example adds the yawp server in the qa test system to the group 
named talisman: 


add_to_group talisman qa yawp 
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add_user 
Add a SMAC user 
Privilege Level 
Admin 
Syntax 
add_user <User Name> <Password> <Password> <Priv> [E-mail] 
where: 
<User Name> 1s an identifier for the user to be added. 
<Password> 1s the password for the new user. It must be specified twice 
on the command line. 
<Priv> is the privilege level for the new user. The privilege level can be 
either "User" or "Admin". 
[E-mail] is the e-mail address of the new user. This parameter is 
required only if the privilege level for the new user is "Admin". 
Alias 
au 
Description 


add_user gives a user privileges to run SMAC commands at level "User" 
or "Admin". A user with a privilege level of "User" can execute only 
commands with a privilege level of "Any" or "User". A user with a 
privilege level of "Admin" can execute all commands. You must specify an 
e-mail address for a new user with the "Admin" privilege level. 


To execute a command with a privilege level of "User" or "Admin", the 


user must first log in to SMAC with the login command. Commands with a 
privilege level of "Any" can be executed by anyone without logging in. 
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Example 
This example creates a new SMAC user, whose user name is joe and whose 
password is jk189. The privilege level for joe is "User", which means joe 


can execute commands at the "Any" and "User" levels. 


add_user joe jk189 jk189 user 
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cmd 


Privilege Level 


Syntax 


Execute a command on a server or a group of servers 


User 


cmd <Server Name | all> [-s] [-r] <Command> 


Or: 


<Server Name> <Command> 


Or: 


<Group Name> <Command> 
where: 


<Server Name | all> specifies the server or servers on which the 
command is to be executed. Specify a server name to execute the 
command on that server. Or, specify all to execute the command on all 
servers in the test system. 


[-s] specifies that the command is to be executed on the samon control 
port for the specified server or servers. 


[-r] specifies that regular expressions are to be used in finding the 
server or servers on which to execute the command. 


<Command> is the command to be executed. 


<Server Name> is the name of the server on which to execute the 
command. Since each server name is registered as a SMAC command, 
this is an easier way to execute a command on a specific server. 


<Group Name> is the name of a group of servers on which to execute 
the command. The command will be executed on all servers in the 
group. Since each group name is registered as aSMAC command, this 
is an easier way to execute a command on a group of servers. 
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Alias 
None 
Description 
cmd executes the specified command on the server or servers indicated. A 
command can be sent to the server only if the server’s connection is up. 
Check the status of the server with the list_server command. If the 
connection is not up, use the init_conn command to create a connection. 
Example 


This example executes a stop_job yawp command (which will bounce the 
yawp server) on the yawp server’s samon port: 


cmd yawp —-s stop_job yawp 


This example executes the source job_config.tcl command on all servers 
in the talisman group: 


talisman source job_config.tcl 
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help 


Get help about SMAC commands 


Privilege Level 


Syntax 


help <smac | Category Name | Command Name> 
where: 


<smac | Category Name | Command Name> specifies the command or 
commands to display help for. Specify smac to display help for all of 
the SMAC commands. Specify a category name to display help for all 
of the commands in a category. Or, specify a command name to display 
detailed help for that command. 


Alias 


None 


Description 


help displays information about SMAC commands. If you specify smac, 
the syntax for all the general commands appears, plus a list of categories of 
other available commands. If you specify a category name, the syntax for 
all of the commands in that category appears. If you specify a command 
name, its syntax, alias, privilege level, and a short description are provided. 


Example 


This example displays help for the list_server command: 


help list_server 


Here is sample output for the above command: 


[-a] <Server | Up | Down | All (default)> (alias: ls) 

Privilege level: Any 

Current status of server connection 

-a: Alphabetize the list (default is sorted by host and then by alphabetics). 
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init_conn 
Connect to a server’s control port 


Privilege Level 


User 


Syntax 


init_conn <Server Name | all> [Retry Time] 
where: 


<Server Name | all> specifies the server or servers to connect to. 
Specify a server name to connect to that server. The server name is 
evaluated as a regular expression to determine the server or servers to 
connect to. Or, specify all to connect to all of the servers in the test 
system. 


[Retry Time] is the number of seconds to wait before automatically 
reconnecting to the server if the connection is lost. If this parameter is 


omitted, there will be no attempt to reconnect to the server if the 
connection 1s lost. 


Alias 
ic 

Description 
init_conn initializes a connection to the specified server’s control port. If 
the server’s status is lost, stopped, or uninit, you need to execute init_conn 


before you can execute a command (using cmd) on the server. Check the 
status of a server with the list_server command. 


Example 


This example initializes a connection to the yawp server. If the connection 
goes down, it will automatically be restarted after 25 seconds: 


init_conn yawp 25 
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keep open 


Privilege Level 


Syntax 


Alias 


Description 


Example 


Keep an open connection to a server to receive data 





User 
keep_open [-c] [-g data] <Server Name> 
where: 


[-c] specifies that the server, currently being kept open, is to be closed. 


[-g data] specifies that grep -i is to be performed on the specified 
data before displaying it. 


<Server Name> is the name of the server to accept data from. 


keep_open allows you to receive asynchronous output from the server. 
Asynchronous (unsolicited) data is any data that the server sends to your 
control port that you did not request. keep_open is often used for "kitchen 
sink logging", which automatically sends messages about everything that’s 
happening on the server to your control port. 


Normally (without keep_open), you would receive data only in response to 
an action that you take. 


This example opens a connection to the yawp server to receive unsolicited 
data. Unsolicited data containing the string "mail" will be sent to you: 


keep_open -g mail yawp 
This example closes the connection to the yawp server: 


keep_open -c yawp 
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kill_ tool 
Kill the SMAC process 
Privilege Level 
Admin 
Syntax 
kill_tool 
Alias 
None 
Description 
kill_tool sends an Instant Message to every user logged in to SMAC that 
SMAC will be going down in 10 seconds. The SMAC process is then 
killed after 10 seconds. 
Example 


This example kills the SMAC process: 


kill_tool 
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list_groups 
List the groups in a test system 


Privilege Level 


User 
Syntax 
list_groups [-c] [regexp] 
where: 
[-c] specifies that the status of the servers in each group is listed along 
with the group. 
[regexp] specifies a regular expression to be evaluated on the results 
of the command. 
Alias 
lg 
Description 
list_groups lists each group in the test system. If you specify the -c option 
for a complete listing, the status of the servers in each group is also listed. 
Example 


This example lists all of the groups and the servers within the groups for the 
current test system: 


list_groups -c 
This example just lists all of the groups: 
list_groups 


Here is sample output for the above command: 


talisman 
tpod_l 
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List each server along with its current status 


Privilege Level 


Syntax 





list_server [-a] [-h Host] <Server Name | up | down | all> 


Alias 


ls 


Description 


where: 


[-a] specifies that the servers will be listed alphabetically by server 
name only. By default, the list is alphabetized first by test system and 
then by server name within test system. 


[-h] specifies that only servers running on the specified host will be 
listed. 


<Server Name | up | down | all> specifies which servers to list. 
Specify a server name to list a specific server. The server name is 
evaluated as a regular expression to determine the server or servers on 
which to display a status list. Specify up to list all servers whose 
connections are up. Specify down to list all servers whose connections 
are lost, stopped, or uninit. Or, specify all to list all servers. all is the 
default. 


list_server provides the following information for each specified server: 


Name The name of the server 

Host The host the server is running on 

Port The port number for the server process 
Sys The test system the server belongs to 
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Status 


Port 


Samon 


K/O 


February 1999 


The current status of the server connection: 


¢ Up means that the server is currently connected. 


¢ Lost means that the server had a connection but is no 
longer connected. 


e Stopped means that the server connection was stopped 
with the stop_conn command. 


¢ Uninit means that a connection to the server has not 
been attempted. 


The samon port number, if the server is controlled by a 


samon. 


The current status of the server connection on the samon 
port. The status values are the same as those listed above. 


The keep open status of the server. If the status is yes, the 
user has a connection being kept open to that server. The 
keep_open command is used to establish an open 

connection to a server. 














Example 

This example lists the status of all mail servers. The status listing will be in 

alphabetic order according to server name: 

list_server -a mail 

Here is sample output for the above command: 
Name Host Port Sys. Status Port Samon K/O 
mai tpod64.test 39465 qa up 39000 up 
mail_abc tpod64.test 39468 qa lost 39000 up 
mail_xyz tpod64.test 39467 ga up 39000 up 
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list_users 


Privilege Level 


Syntax 


Alias 


Description 


Example 


Technical Note: SMAC Tool 


List users 


User/Admin 


list_users [-a] 
where: 
[-a] specifies that all users known to the SMAC tool are to be listed. If 


this option is omitted, only those users currently logged in are listed. 
This option is available only to users with the "Admin" privilege level. 


1a 


list_users lists all logged in users and their privilege levels. If you have the 
"Admin" privilege level, you can specify that all known users are listed, not 
just those currently logged in. 


This example lists the users currently logged in: 


list_users 


Here is sample output for the above command: 








Name Privilege 
joe User 
sarahk User 
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login 
Log in to the SMAC tool 
Privilege Level 
Any 
Syntax 
login <User Name> <Password> [New Password <New Password>] 
where: 
<User Name> 1s the user name for the user logging in. 
<Password> is the password for the user logging in. 
<New Password> 1S anew password for the user logging in. Use this 
parameter only if you want to change your password. 
Alias 
su 
Description 
login logs a user into the SMAC tool. A user must log in to execute any 
SMAC commands requiring a privilege level of "User" or above. SMAC 
commands requiring a privilege level of "Any" do not require the user to 
log in before executing them. 
Example 


This example logs in the user joe: 


login joe jk189 
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mod_server 


Privilege Level 


Syntax 


Alias 


Description 


Example 


Technical Note: SMAC Tool 


Modify server specifications 


User 





mod_server <Server Name> [-n <Name>] [-h <Host>] [-p <Port>] 
[-s <Samon Port>] 


where: 
<Server Name> is the name of the server you want to modify. 


[-n <Name>] specifies that the server’s name will be changed to 
<Name>. 


[-h <Host>] specifies that the server’s host will be changed to 
<Host>. 


[-p <Port>] specifies that the server’s port number will be changed to 
<Port>. 


[-s <Samon Port>] specifies that the server’s samon port number will 
be changed to <Samon Port>. 


ms 


mod_server allows you to change the server’s name, host, port number, 
and samon port number. 


This example modifies the yawp server, changing its name to yelp and 
changing its port to 38221: 


mod_server yawp -n yelp -p 38221 
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new_user 


Submit a request for a SMAC user account 


Privilege Level 


Syntax 





new_user <First Name> <Last Name> <E-mail> <User Name> 
where: 
<First Name> is your first name. 


<Last Name> 1s your last name. 


A 


E-mail> 1s your e-mail address. 





<User Name> 1s the user name you are requesting for your SMAC 
account. 


Alias 


None 


Description 


new_user sends an e-mail message to all SMAC administrators (users who 
have the "Admin" privilege level) that you are requesting a SMAC account. 
A SMAC user account is required to execute SMAC commands above the 
"Any" privilege level. 


A SMAC administrator will respond to your request and assign you a user 
name (usually the user name you requested, unless it is already taken), a 
password, and an appropriate privilege level. Most users receive the "User" 
privilege level. 


After obtaining a new user account, you should change your password 
using the login command (see page 30). 
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Example 
This example requests a user account: 


new_user Joseph Darby JoeD@aol.com joe 
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remove_from_group 


Remove a server from a group 


Privilege Level 


User 


Syntax 





remove_from_group <Group Name> <Test System> <Server Name> 
where: 


<Group Name> is the name of the group the server is to be removed 
from. 


<Test System> is the name of the test system the server belongs to. 
Since different servers in different test systems may have the same 


name, the test system is required to correctly identify the server. 


<Server Name> is the name of the server to be removed. 
Alias 
rfg 


Description 


remove_from_group removes a server from a group. The server remains, 
but it is no longer associated with the group. 


Example 


This example disassociates the yawp server from the talisman group in the 
qa test system: 


remove_from_group talisman ga yawp 
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remove_group 


Remove a group 


Privilege Level 


User 
Syntax 
remove_group <Group Name> 
where: 
<Group Name> is the name of the group you want to remove. 
Alias 
rg 
Description 
remove_group removes a group. The servers that belonged to the group 
still remain, but they are no longer associated with that group. 
Example 


This example removes the talisman group: 


remove_group talisman 
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remove_ server 
Remove a server 


Privilege Level 








User 
Syntax 
remove_server <Test System> <Server Name> 
where: 
<Test System> is the name of the test system to which the server 
belongs. Since different servers in different test systems may have the 
same name, the test system is required to correctly identify the server. 
<Server Name> 1s the name of the server to be removed. 
Alias 
rs 
Description 
remove_server removes the server from the permanent list of servers. 
Example 


This example removes the yawp server from the qa test system: 


remove_server qa yawp 
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set_system 


Specify the test system to work with 


Privilege Level 


Syntax 


| all] 


set_system [Test System 


where: 


[Test System | all] specifies the test system in which to execute 
SMAC commands. Specify the name of a test system to work with, or 
specify all to work with all test systems. If you don’t specify anything, a 
list of the available test systems appears. 


Alias 


ss 


Description 
set_system specifies the test system within which all subsequent SMAC 
commands will be executed. Once you set the test system you want to work 
with, the current test system appears as the command line prompt. 
Example 
This example sets the current test system to qa: 
set_system qa 


This example displays a list of the available test systems: 


set_system 
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spawn 
Spawn a telnet session to a server 


Privilege Level 
User 
Syntax 
spawn <Server Name> <Display Host> 
where: 
<Server Name> is the name of the server to spawn a telnet session to. 


<Display Host> 1s the name of the host on which to display the xterm. 


Alias 


None 


Description 
spawn creates an xterm with a telnet session to the specified server. If you 


want to use Spawn to create an xterm on your terminal, you must give 
SMAC access to your terminal by executing xhost +. 


Example 


This example creates an xterm on the pod2.test host with a telnet session to 
the yawp server: 


spawn yawp pod2.test 
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stop conn 


Stop a connection to a server 


Privilege Level 


User 


Syntax 


stop_conn <Server Name | all> 
where: 
<Server Name | all> specifies the server or servers on which to stop 
a connection. Specify a server name to stop the connection to that 
server. The server name is evaluated as a regular expression to 


determine the server or servers on which to stop a connection, or 
specify all to stop connections to all servers. 


Alias 
Sc 
Description 


stop_conn stops the connection to the specified server’s control port. You 
can use init_conn to restart the connection if needed. 


Example 
This example stops the connection to the yawp server: 


stop_conn yawp 
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tell 


Send an Instant Message to another user 


Privilege Level 





User 
Syntax 
tell <User Name> <Message> 
where: 
<User Name> 1s the name of the user to send an Instant Message to. 
<Message> 1s the text of the message to send to the user. 
Alias 
im 
Description 
tell sends an Instant Message to the specified SMAC user. The user must 
be logged in to receive a message. Use the list_users command to see 
which users are logged in. 
Example 


This example sends an Instant Message to the user joe: 


tell joe Can you stop by my office after lunch? 
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whoami 


Display the current user’s user name and privilege level 


Privilege Level 


User 
Syntax 
whoami 
Alias 
None 
Description 
whoami displays the user name and privilege level of the user currently 
logged in. 
Example 


This example displays the user name and privilege level for the current 
user: 


whoami 


Here is sample output for the above command: 


User: joe 
Privileges: User 
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D 


down status, 27 


G 

groups 
adding servers to, 17 
creating, 15 
executing commands on, 20 
listing, 26 
removing, 35 
removing servers from, 34 


H 
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command, 22 
on SMAC commands, 9 
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I 
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K 

keep_open command, 24 
kept-open connection, 12 
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kitchen sink logging, 12 


L 
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new_user command, 32 
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accessing, 8 
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U 
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